<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-whc_version="24.1">
    <head><link rel="shortcut icon" href="../oxygen-webhelp/template/images/favicon.ico"/><link rel="icon" href="../oxygen-webhelp/template/images/favicon.ico"/><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="generator" content="DITA-OT"/><meta name="description" content="This documentation focuses on video editing of Dolby Vision files in an Android application, and covers support provided in a sample application for critical aspects on both graphics processing unit (graphics processing unit) and display processing unit (display processing unit) platforms and corresponding Dolby Vision versions."/><meta name="prodname" content="Dolby Vision"/><meta name="version" content="Version 1.0"/><meta name="rights" content="© 2023 &#xA;                Dolby Laboratories&#xA;            "/>        
      <title>Introduction</title><!--  Generated with Oxygen version 24.1, build number 2022041410.  --><meta name="wh-path2root" content="../"/><meta name="wh-source-relpath" content="guide/c_introduction.xml"/><meta name="wh-out-relpath" content="topics/c_introduction.html"/>
    <!-- Latest compiled and minified Bootstrap CSS -->
    <link rel="stylesheet" type="text/css" href="../oxygen-webhelp/lib/bootstrap/css/bootstrap.min.css"/>
    
    <link rel="stylesheet" href="../oxygen-webhelp/lib/jquery-ui/jquery-ui.min.css"/>
    
    <!-- Template default styles  -->
    <link rel="stylesheet" type="text/css" href="../oxygen-webhelp/app/topic-page.css?buildId=2022041410"/>
    
    
    <script src="../oxygen-webhelp/lib/jquery/jquery-3.5.1.min.js"></script>
    
    <script data-main="../oxygen-webhelp/app/topic-page.js" src="../oxygen-webhelp/lib/requirejs/require.js"></script>
<link rel="stylesheet" type="text/css" href="../oxygen-webhelp/template/fonts/SourceSansPro.css?buildId=2022041410"/><link rel="stylesheet" type="text/css" href="../oxygen-webhelp/template/fonts/material-icons/material-icons.css?buildId=2022041410"/><link rel="stylesheet" type="text/css" href="../oxygen-webhelp/template/css/dolby-webhelp.css?buildId=2022041410"/></head>

    <body id="c_introduction" class="wh_topic_page frmBody">
        <a href="#wh_topic_body" class="sr-only sr-only-focusable">Jump to main content</a>
        
        
        

        <header class="navbar navbar-default wh_header">
    <div class="container-fluid">
        
        
        
        <div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
            <div class="wh_logo_and_publication_title_container">
                <div class="wh_logo_and_publication_title">
                    
                    <!--
                            This component will be generated when the next parameters are specified in the transformation scenario:
                            'webhelp.logo.image' and 'webhelp.logo.image.target.url'.
                            See: http://oxygenxml.com/doc/versions/17.1/ug-editor/#topics/dita_webhelp_output.html.
                    -->
                    <!-- Hide the log in the banner -->
                    <!--<whc:webhelp_logo class="d-none d-sm-block"/>-->
                    <a href="../index.html"><div class=" wh_publication_title "><span class="prodname">
            <span class="keyword">Dolby Vision</span>
         </span><div><span class="subtitle">Content Editing for Third-Party Developers</span></div></div></a>
                    
                    <nav class=" wh_top_menu " aria-label="Menu Container"><ul role="menubar" aria-label="Menu"><li role="menuitem"><span id="c_introduction-d4029e80771-mi" data-tocid="c_introduction-d4029e80771" data-state="leaf" class=" topicref " data-id="c_introduction"><span class="title"><a href="../topics/c_introduction.html">Introduction</a></span></span></li><li role="menuitem"><span id="c_display_management-d4029e80856-mi" data-tocid="c_display_management-d4029e80856" data-state="leaf" class=" topicref " data-id="c_display_management"><span class="title"><a href="../topics/c_display_management.html">Display management</a></span></span></li><li role="menuitem"><span id="c_editing_gpu_shaders-d4029e80932-mi" data-tocid="c_editing_gpu_shaders-d4029e80932" data-state="leaf" class=" topicref " data-id="c_editing_gpu_shaders"><span class="title"><a href="../topics/c_editing_gpu_shaders.html">Editing using the GPU shaders</a></span></span></li><li role="menuitem"><span id="c_signaling_preview-d4029e81009-mi" data-tocid="c_signaling_preview-d4029e81009" data-state="leaf" class=" topicref " data-id="c_signaling_preview"><span class="title"><a href="../topics/c_signaling_previewing.html">HLG signaling and previewing</a></span></span></li><li role="menuitem"><span id="c_chapter3-d4029e81083-mi" data-tocid="c_chapter3-d4029e81083" data-state="leaf" class=" topicref " data-id="c_chapter3"><span class="title"><a href="../topics/c_trimming_remuxing.html">Trimming and remultiplexing</a></span></span></li><li role="menuitem"><span id="r_appendix-d4029e81158-mi" data-tocid="r_appendix-d4029e81158" data-state="leaf" class=" topicref " data-id="r_appendix"><span class="title"><a href="../topics/r_appendix.html">Appendix</a></span></span></li><li role="menuitem"><span id="tocId-d4029e81225-mi" data-tocid="tocId-d4029e81225" data-state="leaf" class=" topicref glossary"><span class="title"><a href="../topics/r_ov_glossary.html">Glossary</a></span></span></li><li role="menuitem"><span id="Chunk1228116482-d4029e80571-mi" data-tocid="Chunk1228116482-d4029e80571" data-state="leaf" class=" topicref frontmatter" data-id="Chunk1228116482"><span class="title"><a href="../topics/Chunk1228116482.html#Chunk1228116482">Notices</a></span></span></li></ul></nav>
                </div>

                <!-- The menu button for mobile devices is copied in the output only when the 'webhelp.show.top.menu' parameter is set to 'yes' -->
                <button type="button" data-target="#wh_top_menu_and_indexterms_link" id="wh_menu_mobile_button" data-toggle="collapse" class="navbar-toggler collapsed wh_toggle_button" aria-expanded="false" aria-label="Toggle menu" aria-controls="wh_top_menu_and_indexterms_link">
                    <span class="navbar-toggler-icon"></span>
                </button>
                
                <!-- Expand/Collapse publishing TOC 
                             The menu button for mobile devices is copied in the output only when the publication TOC is available
                        -->
                <button type="button" data-target="#wh_publication_toc" id="wh_toc_button" data-toggle="collapse" class="custom-toggler navbar-toggler collapsed wh_toggle_button navbar-light" aria-expanded="false" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc">
                    <span class="toggler-icon">
                        <i class="material-icons">view_headline</i>
                    </span>
                </button>
            </div>

            <div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
                
                <!--<whc:webhelp_indexterms_link/>-->
                <!-- Search form -->
                <div class=" wh_product_numbers "><span class="production-version">Version 1.0</span></div>
                <div class=" wh_search_input navbar-form wh_main_page_search " role="form">
                    
                    <div class="wh_welcome"></div>          
                    <form id="searchForm" method="get" role="search" action="../search.html"><div><input type="search" placeholder="Search... " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="Search query" required="required"/><button type="submit" class="wh_search_button" aria-label="Search..."><span>Search...</span></button></div></form>
                    
                </div>
                
            </div>
        </div>
        
    </div>
</header>


        <div class="container-fluid" id="wh_topic_container">
            <div class="row">

                <nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
                    
<div data-tooltip-position="bottom" class=" wh_breadcrumb "><ol class="d-print-none"><li><span class="home"><a href="../index.html"><span>Home</span></a></span></li><li class="active"><div class="topicref" data-id="c_introduction"><div class="title"><a href="../topics/c_introduction.html">Introduction</a><div class="wh-tooltip">This documentation focuses on video editing of Dolby Vision files in an Android application, and covers support provided in a sample application for critical aspects on both graphics processing unit (GPU) and display processing unit (DPU)  platforms and corresponding Dolby Vision versions.</div></div></div></li></ol></div>


                    
<div class="wh_right_tools">
                        <span class="tools-icon"><button class="wh_hide_highlight" aria-label="Toggle search highlights" title="Toggle search highlights"></button></span>
                        <button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="Collapse sections" title="Collapse sections"></button>
                        <div class=" wh_navigation_links "><span id="topic_navigation_links" class="navheader">
<span class="navprev"><a class="- topic/link link" href="Chunk1228116482.html#Chunk1228116482" title="Notices" aria-label="Previous topic: Notices" rel="prev"></a></span>  
<span class="navnext"><a class="- topic/link link" href="c_display_management.html" title="Display management" aria-label="Next topic: Display management" rel="next"></a></span>  </span></div>
<!--External resource link-->

                        <span class="tools-icon"><a onClick="window.print()" href="" title="Print this page"><i class="material-icons">print</i></a></span>
                        

                        <!-- PUBENG-1261 -->
                        <span class="tools-icon"><a href="r_ov_glossary.html" title="Review the glossary"><i class="material-icons">sort_by_alpha</i></a></span>

                        <!-- PUBENG-1199 -->
                        

                        <!-- PUBENG-1207 -->
                        
                    </div>

                </nav>
            </div>

            

            <div class="wh_content_area" id="wh_content_area">
                <div class="row">
                    


                        <nav id="wh_publication_toc" class="col-lg-3 col-md-3 col-sm-12 d-md-block d-none d-print-none" aria-label="Table of Contents Container">
<div id="wh_publication_toc_content">


                            <div class=" wh_publication_toc " data-tooltip-position="right"><span class="expand-button-action-labels"><span id="button-expand-action" role="button" aria-label="Expand"></span><span id="button-collapse-action" role="button" aria-label="Collapse"></span><span id="button-pending-action" role="button" aria-label="Pending"></span></span><ul role="tree" aria-label="Table of Contents"><li role="treeitem" class="active"><div data-tocid="c_introduction-d4029e80771" class="topicref" data-id="c_introduction" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/c_introduction.html" id="c_introduction-d4029e80771-link">Introduction</a><div class="wh-tooltip">This documentation focuses on video editing of Dolby Vision files in an Android application, and covers support provided in a sample application for critical aspects on both graphics processing unit (GPU) and display processing unit (DPU)  platforms and corresponding Dolby Vision versions.</div></div></div></li><li role="treeitem"><div data-tocid="c_display_management-d4029e80856" class="topicref" data-id="c_display_management" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/c_display_management.html" id="c_display_management-d4029e80856-link">Display management</a><div class="wh-tooltip">There are two versions of Dolby Vision capture; the version present on a device depends on the display management processing unit or platform used for Dolby Vision. It is critical that an application can determine which version is present, and can run correctly on both versions. Determining the version reliably involves examining the Dolby Vision codecs present on the device.</div></div></div></li><li role="treeitem"><div data-tocid="c_editing_gpu_shaders-d4029e80932" class="topicref" data-id="c_editing_gpu_shaders" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/c_editing_gpu_shaders.html" id="c_editing_gpu_shaders-d4029e80932-link">Editing using the GPU shaders</a><div class="wh-tooltip">The sample application provides two GPU (graphics processing unit) shaders for editing.  The DPU (display processing unit) is not used for editing, but is used for display.</div></div></div></li><li role="treeitem"><div data-tocid="c_signaling_preview-d4029e81009" class="topicref" data-id="c_signaling_preview" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/c_signaling_previewing.html" id="c_signaling_preview-d4029e81009-link">HLG signaling and previewing</a><div class="wh-tooltip">Adding support for Dolby Vision editing involves understanding how to process hybrid log-gamma (HLG) frames correctly so that the preview surface is aware of their format.</div></div></div></li><li role="treeitem"><div data-tocid="c_chapter3-d4029e81083" class="topicref" data-id="c_chapter3" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/c_trimming_remuxing.html" id="c_chapter3-d4029e81083-link">Trimming and remultiplexing</a><div class="wh-tooltip">When trimming directly on an encoded video bitstream to preserve video quality, Dolby Vision multiplexer information must be added to the MP4 file. Dolby provides a tool to do this that can be integrated into an application.</div></div></div></li><li role="treeitem"><div data-tocid="r_appendix-d4029e81158" class="topicref" data-id="r_appendix" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/r_appendix.html" id="r_appendix-d4029e81158-link">Appendix</a></div></div></li><li role="treeitem"><div data-tocid="tocId-d4029e81225" class="topicref glossary" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/r_ov_glossary.html" id="tocId-d4029e81225-link">Glossary</a></div></div></li><li role="treeitem"><div data-tocid="Chunk1228116482-d4029e80571" class="topicref frontmatter" data-id="Chunk1228116482" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../topics/Chunk1228116482.html#Chunk1228116482" id="Chunk1228116482-d4029e80571-link">Notices</a></div></div></li></ul></div>
                        

</div>
</nav>
                    



                    <div class="col-lg-6 col-md-9 col-sm-12" id="wh_topic_body">
<script type="text/javascript">document.getElementById('wh_topic_body').className += ' fouc';</script>
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true"><span class="close-toc-icon-container"><span class="close-toc-icon"></span></span></button><button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true"><span class="close-toc-icon-container"><span class="close-toc-icon"></span></span></button>

                        
<div class=" wh_topic_content body "><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    <h1 class="- topic/title title topictitle1" id="ariaid-title1">Introduction</h1>
    
    <div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc">This documentation focuses on video editing of <span class="keyword">Dolby Vision</span> files in an Android application, and covers support provided in a sample application for critical aspects on both <span class="keyword">graphics processing unit</span> (<a href="g_6651.html" title="graphics processing unit: A specialized electronic circuit designed for optimal use of memory and accelerated processing to create images in a frame buffer for output to a display device."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">GPU</dfn></a>) and <span class="keyword">display processing unit</span> (<a href="g_6650.html" title="display processing unit: A hardware component of a Qualcomm system-on-chip (SoC) designed for accelerated processing of visual data represented as pixels."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">DPU</dfn></a>)  platforms and corresponding <span class="keyword">Dolby Vision</span> versions.</p>
        <section class="- topic/section section" id="c_introduction__section_overview" data-ofbid="c_introduction__section_overview"><h2 class="- topic/title title sectiontitle">Overview of documentation</h2>
            
            <div class="- topic/p p">This documentation focuses on video editing and previewing of <span class="keyword">Dolby Vision</span> files, which may involve any of the following operations:<ul class="- topic/ul ul" id="c_introduction__ul_gn3_xlf_nwb" data-ofbid="c_introduction__ul_gn3_xlf_nwb">
                    <li class="- topic/li li">Display management</li>

                    <li class="- topic/li li">Editing, including applying pixel-level effects and overlaying text</li>

                    <li class="- topic/li li"><span class="keyword">Hybrid log-gamma</span> signaling and previewing</li>

                    <li class="- topic/li li">Trimming and remultiplexing</li>

                </ul></div>
            <p class="- topic/p p">This documentation has a chapter for each of these operations.</p>
            <p class="- topic/p p">Your application may support some or all of these operations for <span class="keyword">standard dynamic range</span> (<a href="g_2141.html" title="standard dynamic range: An ITU-R BT.709 signal with peak luminance of 100 cd/m²."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">SDR</dfn></a>). However, to support <span class="keyword">Dolby Vision</span>, the procedures used to carry out these operations may differ from your current implementation. </p>
        </section>
        <section class="- topic/section section" id="c_introduction__section_overview_vision" data-ofbid="c_introduction__section_overview_vision"><h2 class="- topic/title title sectiontitle">Overview of <span class="keyword">Dolby Vision</span></h2>
            
            
            
            <p class="- topic/p p"><span class="keyword">Dolby Vision</span> empowers visual creatives to add ultravivid colors, sharper contrast, and richer details to their visual creations. </p>
            <p class="- topic/p p">It unlocks the full potential of <a href="g_4499.html" title="high-dynamic-range imaging: A technique used in imaging and photography to reproduce a greater dynamic range of luminosity than what is possible with standard digital imaging or photographic techniques. The aim is to present a similar range of luminance to that experienced through the human eye."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">HDR</dfn></a> technology by dynamically optimizing image quality based on your  device, platform, and service. </p>
            <p class="- topic/p p"><span class="keyword">Dolby</span> enables capturing, editing, viewing, and sharing videos in <span class="keyword">Dolby Vision</span> on a variety of Android Smartphone devices. </p>
            <p class="- topic/p p"><span class="keyword">Dolby</span> welcomes creative application developers and content providers to take advantage of the new capabilities of these devices, update their experiences, and allow their users to make and to enjoy <span class="keyword">Dolby Vision</span> content with exceptional qualities not found in standard video.</p>
        </section>
        <section class="- topic/section section" id="c_introduction__section_display_management" data-ofbid="c_introduction__section_display_management"><h2 class="- topic/title title sectiontitle"><span class="keyword">Dolby Vision</span> capture versions and platforms</h2>
            
            <div class="- topic/p p">There are two different versions of <span class="keyword">Dolby Vision</span> capture, for different display management processing units or platforms: <ul class="- topic/ul ul" id="c_introduction__ul_b23_nrg_nwb" data-ofbid="c_introduction__ul_b23_nrg_nwb">
                    <li class="- topic/li li">A version using the <span class="keyword">graphics processing unit</span> (<a href="g_6651.html" title="graphics processing unit: A specialized electronic circuit designed for optimal use of memory and accelerated processing to create images in a frame buffer for output to a display device."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">GPU</dfn></a>) of the mobile phone</li>

                    <li class="- topic/li li">A version using the <span class="keyword">display processing unit</span> (<a href="g_6650.html" title="display processing unit: A hardware component of a Qualcomm system-on-chip (SoC) designed for accelerated processing of visual data represented as pixels."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">DPU</dfn></a>) of the Qualcomm Snapdragon 8 Generation 2 chip</li>

                </ul></div>
            
            <dl class="- topic/dl dl">
                
                    <dt class="- topic/dt dt dlterm">Determining the version and platform</dt>
                    <dd class="- topic/dd dd">Some devices have a <a href="g_6650.html" title="display processing unit: A hardware component of a Qualcomm system-on-chip (SoC) designed for accelerated processing of visual data represented as pixels."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">DPU</dfn></a>, but still implement display management processing with their <a href="g_6651.html" title="graphics processing unit: A specialized electronic circuit designed for optimal use of memory and accelerated processing to create images in a frame buffer for output to a display device."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">GPU</dfn></a>. For this case, the sample application provides the <code class="+ topic/ph pr-d/codeph ph codeph">getSupportStatus</code> function of the <code class="+ topic/ph pr-d/codeph ph codeph">CodecSelector</code> utility class, which detects the version of <span class="keyword">Dolby Vision</span> capture installed on the device. The version installed corresponds to the display management processing unit or platform. A function like this should always be used to determine processing appropriate to the display management hardware implementation. </dd>
                
                
                    <dt class="- topic/dt dt dlterm">Applying a lookup table for the version and platform</dt>
                    <dd class="- topic/dd dd">For <span class="keyword">Dolby Vision</span> playback, a 3D lookup table must be applied to every frame.</dd>
                    <dd class="- topic/dd dd ddexpand">For a version and platform using a <a href="g_6651.html" title="graphics processing unit: A specialized electronic circuit designed for optimal use of memory and accelerated processing to create images in a frame buffer for output to a display device."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">GPU</dfn></a>, this requires an extra step. The sample code includes a 3D lookup table that is a best fit for the majority of DCI-P3-compliant displays. The sample application also shows how to apply this lookup table to a texture.</dd>
                    <dd class="- topic/dd dd ddexpand">For a version and platform using the Qualcomm <a href="g_6650.html" title="display processing unit: A hardware component of a Qualcomm system-on-chip (SoC) designed for accelerated processing of visual data represented as pixels."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">DPU</dfn></a>, the <a href="g_6650.html" title="display processing unit: A hardware component of a Qualcomm system-on-chip (SoC) designed for accelerated processing of visual data represented as pixels."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">DPU</dfn></a> acts as a hardware lookup table. The Qualcomm <a href="g_6650.html" title="display processing unit: A hardware component of a Qualcomm system-on-chip (SoC) designed for accelerated processing of visual data represented as pixels."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">DPU</dfn></a> provides much faster and more power-efficient lookup table application than a <a href="g_6651.html" title="graphics processing unit: A specialized electronic circuit designed for optimal use of memory and accelerated processing to create images in a frame buffer for output to a display device."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">GPU</dfn></a>. To enable this, frames sent to the display must be labeled as <a href="g_1906.html" title="hybrid log-gamma: High-dynamic range standard format developed jointly by the British Broadcasting Corporation (BBC) and Nippon Hoso Kyokai (Japan Broadcasting Corporation), and defined in ARIB STD‑B67 and ETSI TS 101 154."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">HLG</dfn></a> (<span class="keyword">hybrid log-gamma</span>). For applications using OpenGL, this is not easy. There is no way to define a <a href="g_1906.html" title="hybrid log-gamma: High-dynamic range standard format developed jointly by the British Broadcasting Corporation (BBC) and Nippon Hoso Kyokai (Japan Broadcasting Corporation), and defined in ARIB STD‑B67 and ETSI TS 101 154."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">HLG</dfn></a> context in OpenGL. Android, however, provides the <a class="- topic/xref xref" href="https://developer.android.com/reference/android/media/ImageWriter" target="_blank" rel="external noopener"><u class="+ topic/ph hi-d/u ph u"><code class="+ topic/ph pr-d/codeph ph codeph">ImageWriter</code></u></a> class to label surfaces as <a href="g_1906.html" title="hybrid log-gamma: High-dynamic range standard format developed jointly by the British Broadcasting Corporation (BBC) and Nippon Hoso Kyokai (Japan Broadcasting Corporation), and defined in ARIB STD‑B67 and ETSI TS 101 154."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">HLG</dfn></a>. (See the information regarding preview, transcoding, and <span class="keyword">hybrid log-gamma</span> signaling.)</dd>
                
            </dl>
            
        </section>
        <section class="- topic/section section" id="c_introduction__section_vision_differences" data-ofbid="c_introduction__section_vision_differences"><h2 class="- topic/title title sectiontitle">Differences with <span class="keyword">Dolby Vision</span></h2>
            
            <dl class="- topic/dl dl">
                
                    <dt class="- topic/dt dt dlterm">Color space</dt>
                    <dd class="- topic/dd dd">Editing supports either one of the <a href="g_6588.html" title="ITU-R Recommendation BT.709: A standard with a color space, for characterizing and encoding high-definition television."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">BT.709</dfn></a> and <a href="g_6587.html" title="ITU-R Recommendation BT.2020: A standard with a color space, for characterizing and encoding ultra-high-definition television."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">BT.2020</dfn></a> color standards. The correct color standard is signaled by the input decoder and the corresponding color space conversions are selected automatically in the editing <a href="g_6651.html" title="graphics processing unit: A specialized electronic circuit designed for optimal use of memory and accelerated processing to create images in a frame buffer for output to a display device."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">GPU</dfn></a> shader.</dd>
                
                
                    <dt class="- topic/dt dt dlterm">Encoder</dt>
                    <dd class="- topic/dd dd">Phones that support <span class="keyword">Dolby Vision</span> have an encoder specific to <span class="keyword">Dolby Vision</span>. This encoder expects <a href="g_6587.html" title="ITU-R Recommendation BT.2020: A standard with a color space, for characterizing and encoding ultra-high-definition television."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">BT.2020</dfn></a> limited range <a href="g_2259.html" title="YUV: A file format that is encoded using the YCbCr color space."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">YUV</dfn></a>
                        <a href="g_1906.html" title="hybrid log-gamma: High-dynamic range standard format developed jointly by the British Broadcasting Corporation (BBC) and Nippon Hoso Kyokai (Japan Broadcasting Corporation), and defined in ARIB STD‑B67 and ETSI TS 101 154."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">HLG</dfn></a> input. </dd>
                
                
                    <dt class="- topic/dt dt dlterm">Decoder</dt>
                    <dd class="- topic/dd dd">Phones that support <span class="keyword">Dolby Vision</span> have a decoder specific to <span class="keyword">Dolby Vision</span>. This decoder communicates the output colour space to the editor application, which influences the behavior of the shader system.</dd>
                
                
                    <dt class="- topic/dt dt dlterm">Multiplexing</dt>
                    <dd class="- topic/dd dd"><span class="keyword">Dolby Vision</span> files that have been trimmed require an additional step after being mastered with the <a class="- topic/xref xref" href="https://developer.android.com/reference/android/media/MediaMuxer" target="_blank" rel="external noopener"><u class="+ topic/ph hi-d/u ph u"><code class="+ topic/ph pr-d/codeph ph codeph">MediaMuxer</code></u></a> utility. You will need to add <span class="keyword">Dolby Vision</span> metadata boxes.</dd>
                
            </dl>
        </section>
        <section class="- topic/section section" id="c_introduction__section_sample_app" data-ofbid="c_introduction__section_sample_app"><h2 class="- topic/title title sectiontitle">Sample application</h2>
            
            <p class="- topic/p p">To assist in your integration, a sample application is provided that integrates <span class="keyword">Dolby Vision</span> video editing. Reviewing the sample application and other materials provided with this documentation is critical to ensuring that your integration is successful. </p>
            <p class="- topic/p p">Although the Android <a href="g_1707.html" title="application programming interface: A set of functions that can be used to access the functions of an operating system or other type of software."><dfn class="+ topic/term abbrev-d/abbreviated-form term abbreviated-form">API</dfn></a> calls used in the sample application are in many cases nonstandard, they are backward compatible with all standard video formats. </p>
            <p class="- topic/p p">This documentation highlights important differences and explains why these differences are necessary. The more critical parts of sample application code are included and explained here. For more details and context, please refer directly to the sample application code and its comments. </p>
            
        </section>
        <section class="- topic/section section" id="c_introduction__section_setting_up" data-ofbid="c_introduction__section_setting_up"><h2 class="- topic/title title sectiontitle">Setting up the sample application</h2>
            
            <p class="- topic/p p">Download the <span class="keyword">Dolby</span> sample application for video editing from GitHub at <a class="- topic/xref xref" href="https://github.com/DolbyLaboratories/dolby-vision-editor" target="_blank" rel="external noopener"><u class="+ topic/ph hi-d/u ph u">https://github.com/DolbyLaboratories/dolby-vision-editor</u></a>. </p>
            <p class="- topic/p p">Download Android Studio at <a class="- topic/xref xref" href="https://developer.android.com/studio" target="_blank" rel="external noopener"><u class="+ topic/ph hi-d/u ph u">https://developer.android.com/studio</u></a>.</p>
            
            <p class="- topic/p p">After installing Android Studio, open the sample application. Android Studio  recognizes the sample application as an Android project, then downloads libraries and builds the project. </p> 
        </section>
        <section class="- topic/section section">
            
            <div class="- topic/note note"><span class="notetitle"><img class="note-icons" src="../oxygen-webhelp/template/images/notes/note-library_books-24px.svg"/>Note:</span> 
                <p class="- topic/p p">This documentation is applicable only for applications that require Android 13 as a minimum. Before proceeding, please ensure that your code is compliant with Android 13 and does not rely on any deprecated functions. </p>
                <p class="- topic/p p">The sample application does not support combining video files.</p>
                <p class="- topic/p p">The sample application has been tested only with <span class="keyword">Dolby Vision</span> profile 8.4. No other profiles are supported.   See <a class="- topic/xref xref" href="https://professionalsupport.dolby.com/s/article/What-is-Dolby-Vision-Profile" target="_blank" rel="external noopener"><u class="+ topic/ph hi-d/u ph u">What are <span class="keyword">Dolby Vision</span> profiles?</u></a> for more information.</p>
            </div>

        </section>
    </div>
</article></main></div>


                        
                        
                        

                        

                    </div>
                    



                        <nav role="navigation" id="wh_topic_toc" aria-label="On this page" class="col-lg-3 d-none d-lg-block navbar d-print-none">
<div id="wh_topic_toc_content">


                            <div class=" wh_topic_toc "><div class="wh_topic_label">On this page</div><ul><li class="section-item"><div class="section-title"><a href="#c_introduction__section_overview" data-tocid="c_introduction__section_overview">Overview of documentation</a></div></li><li class="section-item"><div class="section-title"><a href="#c_introduction__section_overview_vision" data-tocid="c_introduction__section_overview_vision">Overview of Dolby Vision</a></div></li><li class="section-item"><div class="section-title"><a href="#c_introduction__section_display_management" data-tocid="c_introduction__section_display_management">Dolby Vision capture versions and platforms</a></div></li><li class="section-item"><div class="section-title"><a href="#c_introduction__section_vision_differences" data-tocid="c_introduction__section_vision_differences">Differences with Dolby Vision</a></div></li><li class="section-item"><div class="section-title"><a href="#c_introduction__section_sample_app" data-tocid="c_introduction__section_sample_app">Sample application</a></div></li><li class="section-item"><div class="section-title"><a href="#c_introduction__section_setting_up" data-tocid="c_introduction__section_setting_up">Setting up the sample application</a></div></li></ul></div>
                        

</div>
</nav>
                    



                </div>
            </div>


        </div>
        <footer class="wh_footer">

  <div class=" footer-container container-fluid">

   <!-- PUBENG-1263 simplify bootstrap to fix footer stubborness  -->
    <div class=" wh_footer_tiles container-fluid">

        <div class="wh_tile footer-left">
          <!-- PUBENG-1492 adding black icon for print, and hiding white icon for screens -->
          <a href="https://www.dolby.com" target="_blank" class=" wh_logo d-print-none "><img src="../oxygen-webhelp/template/images/Dolby_vertical_White.svg" alt="&#xA;            Dolby Vision&#xA;         "/></a>
          
        </div>

        <div class="wh_tile footer-center">
          <div class="copyright-statement">©2023 Dolby Laboratories. All rights reserved.  Dolby and the double-D symbol are registered trademarks of Dolby Laboratories. All other trademarks remain
        the property of their respective owners.</div>
        </div>

        <div class="wh_tile footer-right">
          <div class="support-links"><div role="support-link"><span class="title"><a href="Chunk1228116482.html#Chunk1228116482">Notices</a></span></div></div>
          1 May 2023<span class="copyright-date"> </span>
          <div class="confidential"></div>
        </div>

    </div>

    <!--    <whc:dolby_footer_title class="d-none d-sm-block"/>-->

    <!--
    
    <!-\-    <whc:include_html href="${webhelp.fragment.footer}"/>-\->
    <div class="permissions_date">
     
    </div>-->

  </div>
</footer>
        <div id="go2top" class="d-print-none">
            <span class="oxy-icon oxy-icon-up"></span>
        </div>
        <!-- The modal container for images -->
        <div id="modal_img_large" class="modal">
            <span class="close oxy-icon oxy-icon-remove"></span>
            <!-- Modal Content (The Image) -->
            <div id="modal_img_container"></div>
            <!-- Modal Caption (Image Text) -->
            <div id="caption"></div>
        </div>
        

    </body>
</html>